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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Technical Conmiittee Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within TC SCP and may change following formal 
TC SCP approval. If TC SCP modifies the contents of the present document, it will then be republished by ETSI with 
an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

early working draft; 

1 presented to TC SCP for information; 

2 presented to TC SCP for approval; 

3 or greater indicates TC SCP approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document defines additional features that shall be provided by the UICC to support EAP authentication 
capabilities. 

The goal of these new features is to adapt the UICC to provide support of different EAP methods, ensuring 
interoperability between the UICC and any terminal independently of their respective manufacturers. 

The present document defines: 

• The architectural framework. 

• The additional commands required. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• In the case of a reference to a TC SCP document, a non specific reference implicitly refers to the latest version 
of that document in the same Release as the present document. 

• Non-specific reference may be made only to a complete document or a part thereof and only in the following 
cases: 

if it is accepted that it will be possible to use all future changes of the referenced document for the 
purposes of the referring document; 

for informative references. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http ://docbox . etsi . or g/Ref erence . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are indispensable for the application of the present document. For dated 
references, only the edition cited applies. For non-specific references, the latest edition of the referenced document 
(including any amendments) applies. 

[1] IETF RFC 3748: "Extensible Authentication Protocol (EAP)". 

NOTE: See at http://www.ietf.org/rfc/rfc3748.txt . 

[2] ETSI TS 102 221: "Smart cards; UICC-Terminal interface; Physical and logical characteristics". 

[3] IETF RFC 2716: "PPP EAP TLS Authentication Protocol". 

NOTE: See at http://www.ietf.org/rfc/rfc2716.txt . 

[4] IETF RFC 4282: "The Network Access Identifier" . 

NOTE: See at http://www.ietf.org/rfc/rfc4282.txt . 

[5] IETF RFC 266 1 : "Layer Two TunneUng Protocol L2TP" . 

NOTE: See at http://www.ietf.org/rfc/rfc2661.txt . 
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[6] IETF RFC 1 66 1 : "The Point-to-Point Protocol (PPP)" . 

NOTE: See at http ://www.ietf .org/rfc/rfc 1 66 1 .txt . 

[7] IEEE Std 802.1X-2004: "IEEE Standard for Local and metropolitan area networks Port-Based 

Network Access Control". 

[8] IEEE Std 802.11-1999: "Telecommunications and information exchange between systems - Local 

and Metropolitan Area networks - Specific requirements - Part 1 1 : Wireless LAN Medium Access 
Control (MAC) and Physical Layer (PHY) Specifications". 

2.2 Informative references 

The following referenced documents are not essential to the use of the present document but they assist the user with 
regard to a particular subject area. For non-specific references, the latest version of the referenced document (including 
any amendments) applies. 

Not applicable. 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following definitions apply: 

authenticator: end of the EAP link initiating EAP authentication 

peer or supplicant: end of the EAP Link that responds to the authenticator 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

DF Dedicated File 

EAP Extensible Authentication Protocol 

EF Elementary File 

L2TP Layer two Tunnelling Protocol 

LAN Local Area Network 

NAI Network Access Identifier 

PPP Point-to-Point Protocol 

TLS Transport Layer Security 

WEP Wired Equivalent Privacy 



Introduction 



The Extensible Authentication Protocol is a general authentication framework, which supports multiple authentication 
methods. EAP typically may run directly over data link layers such as PPP (see RFC 1661 [6]) or 
IEEE Std 802.1X-2001 [7] and IEEE Std 802.11-1999 [8]. 

As described in RFC 3748 [1], EAP implementations consist of three main components: 

• A lower layer that is responsible for transmitting and receiving EAP frames between the peer and the 
authenticator. EAP has been run over a variety of lower layers (including PPP, IEEE 802 LANs, IEEE 802.1 1 
WLANs, and L2TP (see RFC 2661 [5])). 

• An EAP layer that receives and transmits EAP packets via the lower layer, implements duplicate detection 
and retransmission, and delivers and receives EAP messages to and from EAP methods. 
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• EAP methods that implement the authentication algorithms and receive/transmit EAP messages via the EAP 
layer. 

The UICC offers suitable possibilities for the implementation of some of these EAP methods in the peer side, since it 
provides the required protection of credentials and authentication algorithms. This is even more important when the 
following conditions apply: 

• The authentication methods require the usage of credentials that are stored in the UICC. 

• For security reasons, these credentials shall not be revealed in clear in an unprotected peer environment 
(e.g. a laptop or mobile terminal). 

The present document defines the principles that shall be implemented in the UICC in order to enable that UICC 
applications may support one or more of these EAP methods. 



5 Architecture 

5.1 Architectural Principles 

The following architectural principles are applied: 

• The authenticator is able to perform an EAP authentication process (using an specific EAP method) with a 
UICC application implementing this method. That means that the authentication is performed end-to-end 
between the authenticator and the UICC application. 

• The peer is composed of several components: 

The UICC EAP Framework provides information to the terminal about the existing UICC applications 
that provide UICC EAP cHents. 

A UICC application provides one or more UICC EAP clients. 

A UICC EAP dient implements one specific EAP method. 
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Figure 5.1 : EAP architecture when supplicant is split between a UICC and a terminal 



5.2 EAP clients discovery 



When a UICC application implements one or more EAP clients, its corresponding record in EFj^jj^ shall contain the 
following EAP related Data Objects: 

• Application EAP support types list: defining the EAP methods supported by the corresponding UICC 
application. 



ETSI 



Release 8 



ETSI TS 102 310 V8.1.0 (2009-04) 



Application EAP Dedicated File list: defining a list of Dedicated Files, each of them associated to one 
supported EAP method. Likewise, each EAP method is associated to one DF. Each of this DF are hereafter 
referred as DFg^p. 

Application EAP Label: Defining a user readable label defining the EAP clients. 

Table 5.1 : Coding of EAP related DOs 



Length 


Description 


Status 




Discretionary template tag = 73' 


M 




Length of the discretionary template 


M 




EAP Application service specific data content tag (='A0') 


M 




EAP Application service specific data content length 


M 




Application EAP supported types list tag = '80' 


M 




Length of the Application EAP supported types list 


M 


A 


Application EAP supported types list 


M 




Application EAP Dedicated file list tag = '81' 


M 




Length of Application EAP Dedicated file list 


M 


B 


Application EAP Dedicated File list 


M 




Application EAP Label tag = '82' 


M 




Length of the Application EAP Label 


M 


C 


Application EAP Label 


M 



Coding: 

• Application EAP supported types list: 

Contain a list of supported EAP type (as defined in RFC 3748 [1]) each of them coded in one byte except for expanded 
types that are coded on 8 bytes. 

EXAMPLE 1: An UICC application supporting EAP-MD5 (see RFC 3748 [1]) and EAP-TLS (see RFC 2716 [3]) 
provides the following "Application EAP supported types list": 

'040D'corresponding to EAP-MD5 (Type=4) and EAP-TLS (Type=13). 

• Application EAP Dedicated Files list: 

Contain a list of file identifiers of each DFg^p associated to a particular supported EAP type. Each of them coded in 
two bytes. 

EXAMPLE 2: Using the previous example, A DF '6D34' for EAP-MD5 and a DF '6D35' for EAP-TLS will result 
in the following EAP Dedicated Files list: 

'6D346D35'. 

• Application EAP label: 

The application label is a DO that contains a string of bytes provided by the application provider to be shown to the user 
for information. 
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5.3 EAP-capable-application selection 

The terminal shall use the information in EFj^jj^ file if available to present the list of EAP-capable applications to the 
user or to any application that may request an EAP authentication. 

The terminal shall then select the corresponding EAP-capable-application to start an EAP authentication. Once selected, 
all EAP-Client state machines of the application are reset. 

5.4 Key derivation 

It is possible for many EAP methods to derive key material after successful authentications. These keys may be used for 
subsequent processes (e.g. for WEP encryption in IEEE Std 802.11-1999 [8]). 

Keys derived from an authentication shall be retrieved by the terminal by inspecting the file EFg^pj^ys- 

5.5 Autiientication Status 

The terminal may retrieve the authentication status of the EAP client in the selected UICC application by inspecting the 
mandatory file EFeapstatus- 



6 EAP related Commands 

The following clauses specify the additional commands needed to implement the EAP framework in the UICC. 

6.1 EAP Authenticate 



6.1 .1 Command description 



The function is used to transfer the EAP packets from the terminal to the selected UICC EAP client (i.e. EAP client in 
the selected UICC application that corresponds to the given EAP type). 

The UICC EAP client shall provide a response EAP packet (as defined in RFC 3748 [1]) or a warning status word 
according to the authentication method being used. 

The UICC EAP client shall maintain the state machine of the authentication process as described for the particular EAP 
method used. 

The function is related to a particular UICC application supporting EAP and shall not be executable unless this 
application has been selected and activated, and the current directory is a DFg^p corresponding to a specific EAP 
method. The correspondence between EAP type and the current DFg^p is defined in EFj^jj^. 

Each UICC application implementing a UICC EAP client may require different security conditions to execute this 
command (e.g. user PIN verification). 

The format of the EAP packet is defined by the application implementing the EAP client and shall respect the 
conventions corresponding for the EAP method. 

The following EAP packets are allowed input packets for this command: EAP packets with code field equal to 

1 "Request", 3 "Success" or 4 "Failure" and EAP packets with code equal to 2 "Response" for EAP type 1 "Identity" 

(Code and type values as defined in RFC 3748 [1]). 

NOTE: EAP Response Identity packet may be delivered to the UICC application when the identity is managed 
outside the UICC application and the method itself needs to have access to the chosen identity. 

The command and response data may contain specific EAP method related data as an additional input/output parameter 
(e.g. gmt_unix_time for EAP-TLS implementations as defined in RFC 2716 [3]). 
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Depending on the length of the EAP input data, the EAP Authenticate may be used with an EVEN or ODD INS code. 
In the latter case, the EAP input and response data shall be encapsulated in BER TLV data objects, as specified in 
TS 102 221 [2]. 

Input: 

• EAP Packet; 

• EAP method related data. 
Output: 

• Either none (i.e. if authentication successful: EAP success packet received). 
Or: 

• EAP Response Packet; 

• EAP method related data. 



6.1.1.1 



Command parameters and data 



Code 


Value 


CLA 


As specified in ETSI TS 102 221 [2] 


INS 


As specified in ETSI TS 102 221 [2] 


P1 


As specified in ETSI TS 102 221 [2] 


P2 


See table 6.1 


Lc 


Length of subsequent EAP command data 


Data 


See below 


Le 


Length of the response data 



Table 6.1: Coding of P2 



b8 


b7 


b6 


b5 


b4 


b3 


b2 


b1 


Meaning 


1 


- 


- 


- 


- 


- 


- 


- 


Specific reference data (DF ^j^p application 
dependent KEY) 


- 


X 


X 


- 


- 


- 


- 


- 


'00' (other values are RFU) 


- 


- 


- 


X 


X 


X 


X 


X 


Reference data number ('01 ' to '1 F') 


























See TS 102 221 [2] 


NOTE: The reference data number assignment rule shall be defined in the application 
specification referencing the present document. 



The reference data number assignment rule shall be defined in the application specification referencing the present 
document. In case the UICC based application specification does not define a Reference Data Number for the EAP 
AUTHENTICATE command, then P2 shall be set to '00'. 

Command data: 



Byte(s) 


Description 


Length 


1 toLc 


EAP command data (see table 6.2) 


Lc 
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Table 6.2: Coding of EAP command data 



Byte(s) 


Description 


Status 


Length 


1 to J 


EAP packet (coded as defined for the method 
of EAP used as defined in RFC 3748 [1]) 


M 


J bytes 


J+1 to 
J+K+1 


EAP method related data (must be specified by 
each application specific document defining a 
particular EAP method implementation) 





K bytes 


NOTE: The length of an EAP packet is contained within the packet and can therefore be 
retrieved from it. 



Response data: 



Byte(s) 


Description 


Length 


1 toLe 


EAP Packet Response Data (see table 6.3) 


Le 



Table 6.3: Coding of EAP Response data 



Byte(s) 


Description 


Status 


Length 


1 toL 


EAP packet 


M 


L bytes 


L+1 to 
L+N+1 


EAP method related data (must be specified by 
each application specific document defining a 
particular EAP method implementation) 





N bytes 


NOTE: The length of an EAP packet is contained within the packet and can therefore be 
retrieved from it. 



6.2 Specific status conditions returned 

This clause specifies the coding of the specific status words SWl and SW2. 

6.2.1 Status words 

Table 6.4 shows the meaning of possible status conditions returned. 

Table 6.4: Status byte coding - warnings 



SW1 


SW2 


Description 


'62' 


'00' 


- No information given, state of non volatile memory unchanged (EAP 
Packet silently ignored) 


Table 6.5: Status byte coding - application errors 


SW1 


SW2 


Description 


'98' 


'62' 


- Authentication error (EAP Failure Packet received) 
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EAP Files 



This clause describes the files present in an application supporting an EAP type. The following files are situated under 
the corresponding DFg^p of a particular UICC application. 



7.1 



EF 



EAPKEYS 



(EAP derived keys) 



This EF contains the key material derived after a successful EAP authentication. 

Structure of EF^^pkeys 



Identifier: '4F01' 


Structure: transparent 


Conditional 
(see note) 


File size: n Update activity: high 


Access Conditions: 
READ PIN 
UPDATE ADM/NEVER 
DEACTIVATE ADM 
ACTIVATE ADM 


Bytes 


Description 


IVI/0 


Length 


1 


1 St Key Tag 





1 bytes 


2 


ist Key Length 





1 bytes 


3toL1+2 


ist Key Value 





L1 bytes 










2(k-1) + L1 + +L(k-1) + 1 


KSt Key Tag 





1 bytes 


2(k-1) + L1 + +L(k-1)+ 2 


KSt Key Length 





1 bytes 


(2(k-1) + L1 + +L(k-1)+ 3) to 
(L1 + ... + Lk + 2k) 


KSt Key Value 





LK bytes 


(L1 +... + Lk + 2k+1)ton 


'FF' padding 







NOTE: The presence of this file depends on the supported EAP method. 



Key Tag 

Contents: 

■ Identifier of the derived key. 
Coding: 

■ The assigned Key tag values are given in the following table. 



Derived key description 


Key tag value 


Reference 


Master Session Key (MSK) 


'80' 


RFC 3748 [1] 


Extended Master Session Key (EMSK) 


'81' 


RFC 3748 [1] 



Key Length 
Contents: 

■ Length of the derived key. 
Key Value 

Contents: 

■ Derived key. 



ETSI 



Release 8 



13 



ETSI TS 102 310 V8.1.0 (2009-04) 



7.2 



EF 



EAPSTATUS 



(EAR Authentication STATUS) 



This EF contains the authentication status corresponding to the EAP client supported by the appUcation. 

Structure of EFeapstatus 



Identifier: '4F02' 


Structure: transparent | Mandatory 


File size: 1 




Update activity: high 


Access Conditions: 
READ PIN 
UPDATE 
DEACTIVATE 
ACTIVATE 


ADM/NEVER 

ADM 

ADM 




Bytes 


Description 


M/0 


Length 


1 


Authentication Status 


M 


1 bytes 



Authentication Status 
Contents: 

■ Status of the corresponding EAP authentication. 
Coding: 

■ Authentication Status coded in one byte as below. 



Value 


Meaning 


'00' 


No authentication started 


'01' 


Authenticating 


'02' 


Authenticated 


'03' 


Held (Authentication failure) 



7.3 EFpuid (Permanent User Identity) 



This EF contains the permanent user identity. Permanent User identity may be used as the username part of the Network 
Access Identifier (see RFC 4282 [4]). 

This File is not mandatory if the Permanent user identity is derived by other means. 

Structure of EFpyi^j 



Identifier: '4F03' Structure: transparent Optional 


File size: n (where n >1 bytes) Update activity: low 


Access Conditions: 
READ PIN 
UPDATE ADM 
DEACTIVATE ADM 
ACTIVATE ADM 


Bytes 


Description 


M/0 


Length 


1 ton 


Permanent user identity 


M 


n bytes 
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• Permanent user identity 
Contents: 

■ user identity to be used as the username part of the NAI. 
Coding: 

■ Binary. Unused bytes at the end shall be set to "FF" and shall not be considered as a part of the 
value. 



7.4 EFp3 (Pseudonym) 



This EF contains a temporary user identifier (pseudonym) for subscriber identification. Pseudonyms may be provided as 
part of a previous authentication sequence. This may be used as the username part of the Network Access Identifier 
(see RFC 4282 [4]). 

This file is not mandatory if pseudonyms are not managed by the application or they are derived by other means. 

Structure of EFpg 



Identifier: '4F04' Structure: transparent Optional 


File size: n Update activity: high 


Access Conditions: 
READ PIN 
UPDATE PIN 
DEACTIVATE ADM 
ACTIVATE ADM 


Bytes 


Description 


M/0 


Length 


1 ton 


Pseudonym 


M 


n bytes 



Pseudonym 
Contents: 

■ Pseudonym to be used as the username part of the NAI. 
Coding: 

■ Binary. Unused bytes at the end shall be set to "FF" and shall not be considered as a part of the 
value. 
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Annex A (informative): 
Change history 



This annex lists all change requests approved for the present document by ETSI SCP. 



SCP# 


SCP 
tdoc 


VERS 


CR 


RV 


CAT 


SUBJECT 


Resulting 
Version 


19 


SCP-040420 


6.0.0 


001 
002 




F 
F 


Clarification on references and clarification on the coding of P2 

authenticate parameter 

Allocation of new tag values for EAP 


6.1.0 


22 


SCP-050246 


6.1.0 


003 




F 


Clarification on the coding of P2 in the EAP authenticate command 


6.2.0 


35 




6.2.0 


- 


- 


- 


Rel-7 version is created from the lateset Rel-6 version, with no 
technical changes 


7.0.0 




35 


SCP-080039 


6.2.0 


004 


1 


B 


EAP Authenticate correction (Alignment with TS 102 221 for 
Extended Authenticate) 


8.0.0 


40 


SCP-090026 


8.0.0 


005 


- 


F 


Multiple Corrections 


8.1.0 
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Document history 


V8.0.0 


September 2008 


Publication 
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